home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 February / EnigmA AMIGA RUN 15 (1997)(G.R. Edizioni)(IT)[!][issue 1997-02][PLANET CD V].iso / enigma / earcd / utility / utilcli / binhex.lha / BinHex.readme < prev   
Text File  |  1996-11-21  |  3KB  |  76 lines
  1. Short:    use favorite ASCII editor for HEX data V1.12
  2. Uploader: stoecker@rcs.urz.tu-dresden.de (Dirk Stoecker)
  3. Author:   stoecker@rcs.urz.tu-dresden.de (Dirk Stoecker)
  4. Type:     util/cli
  5. Version:  1.12
  6. Kurz:     Programm, um HEX-Daten mit ASCII Editor zu editieren
  7.  
  8. This program converts data (for example program code) into the hexadecimal
  9. data system. This data could be edited with your favorite ASCII text
  10. editor. After that you can convert the data back to their old style. So you
  11. don't need a special hex editor and you will be able also to delete parts
  12. of the file, insert parts and so on. Most hex editors allow only to change
  13. given data.
  14.  
  15. Be sure that you know what you are doing! To insert some data into program
  16. most time crashes the program, because the internal addresses are now
  17. illegal. But the ability to delete data is useful for removing start code
  18. from modules, pictures or text.
  19.  
  20. BinHex needs OS 37 (2.0) or later OS versions!
  21.  
  22. USAGE:
  23.   BinHex BIN/A,HEX/A,MAKEBIN/S,ONLYDATA/S,ROWS/N,ASMDATA/S
  24.   BIN      give filename for original data file
  25.   HEX      give filename for hexadecimal data
  26.   MAKEBIN  set program to convert HEX to BIN (else BIN to HEX)
  27.   ONLYDATA add no ASCII output and no position info to hex data file
  28.   ROWS       give number of rows in one line (1 row = 4 byte)
  29.   ASMDATA  creates a field of ASM DC.L lines (not convertable back to bin).
  30.   CDATA    creates a ULONG data[] = { ... } fiels (not convertable back).
  31.  
  32. The options ASMDATA and CDATA create an output useable in an assembler or
  33. C compiler. There are always ULONG fields created, so it may be that the
  34. last number is incorrect. Please edit this one by hand.
  35.  
  36. To make it impossible to overwrite binary data if not wanted use every time
  37. one of the BIN or HEX keywords, but they aren't needed!. «BinHex A B» is
  38. same as «BinHex A HEX B», but the second is saver.
  39.  
  40. hexadecimal data format:
  41.   In the hex file the data is only interpreted from begin of line to next
  42.   tabulator (\t, $09). If there is no tabulator in line it is done from
  43.   begin of line to next return (\n, $0A). All other parts and spaces are
  44.   ignored!
  45.   If there is a \ in the data part all following chars to the next
  46.   tabulator (or return) are not converted. They are taken like given (good
  47.   for inserting readable text).
  48.  
  49.   example 1:
  50.   BIN data in RAM:A       Hello World!
  51. call BinHEX RAM:A HEX RAM:B ONLYDATA
  52.   HEX data in RAM:B       48656C6C6F20576F726C6421
  53.  
  54.   example 2:
  55.   HEX data in RAM:B      4865 6C6c 6f20\World!
  56. call BinHEX RAM:A HEX RAM:B MAKEBIN
  57.   BIN data in RAM:A       Hello World!
  58.  
  59. Please report bugs, comments, suggestions, problems to me. If possible
  60. write a little mail if you use the program sometimes. If there are some
  61. enforcer hits or other problems report them as good as possible (I can't
  62. start enforcer!).
  63.  
  64. Don't forget BinHex including source is Public Domain! I hope some more
  65. programmers follow the PD/Freeware idea. Shareware is good, but why pay
  66. for example 20$ for a very little utility?
  67.  
  68. Please contact me:
  69.  
  70. ***************************************************************************
  71. * snail-mail: Dirk Stoecker              * e-mail:                        *
  72. *             Geschwister-Scholl-Str. 10 * stoecker@rcs.urz.tu-dresden.de *
  73. *             01877 Bischofswerda        * phone:                         *
  74. *             GERMANY                    * GERMANY 03594/706666           *
  75. ***************************************************************************
  76.